home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / internet-tools / amitcp / amitcp-2.2 / doc / napsaterm.doc < prev    next >
Encoding:
Text File  |  1993-11-04  |  9.1 KB  |  253 lines
  1.  
  2.     Napsaterm.doc
  3.  
  4.     Copyright © 1993 AmiTCP/IP Group, <amitcp-group@hut.fi>,
  5.                      Helsinki University of Technology, Finland.
  6.                      All rights reserved.
  7.  
  8.     Author: Pekka Pessi, <Pekka.Pessi@hut.fi>
  9.  
  10.     Napsaterm is based on Niftyterm terminal emulator by Christopher
  11.     Newman and Todd Williamson.
  12.  
  13.     $Id: napsaterm.doc,v 1.5 1993/11/03 21:23:05 ppessi Exp $
  14.  
  15. What Is Napsaterm
  16.  
  17.     At first Napsaterm was a version of Niftyterm 1.2 with some support
  18.     for international keyboards layouts and character sets. It is
  19.     called Napsaterm because original authors wanted to keep distinction
  20.     clear between it and their versions of Niftyterm. 
  21.  
  22.     Napsaterm supports some obscure ISO 646 national character sets. The
  23.     ISO 8857-Latin-1 character set is also supported.  The multinational
  24.     support is not really finished, eg. the font files are not complete.
  25.     Most national support functions are located in files national.[hc].
  26.  
  27.     The AmiTCP/IP BSD socket interface was added to Napsaterm after the
  28.     porting of real rlogin program seemed to take too much effort and
  29.     time. The rlogin protocol is a very simple, however the interactive
  30.     IO with AmigaDOS is far too ineffective. Fortunately Niftyterm IO
  31.     implementation was extremely flexible and it was easy to add new IO
  32.     methods.
  33.  
  34.     This file was written in the documentation-is-just-like-a-sex
  35.     spirit. Even when it is bad, it is better than nothing. If you don't
  36.     like sex, try pizza. Most of the Niftyterm 1.2 documentation is up
  37.     to date. It is included with this distribution.
  38.  
  39. Invoking Napsaterm
  40.  
  41.     You can start Napsaterm with following command line options and
  42.     parameters:
  43.  
  44.   napsaterm [-V] [-vt102] [-vt52] [-h19] [-7] [-l file] [-w] [-slow]
  45.             [-g geometry] [-80] [-f fontname] [-ic] [-v] [-S screen] 
  46.             [-d device] [-u unit] [-shared] [-stdio] [-N net] 
  47.             [-B linespeed] [-p programtitle] [host]
  48.  
  49.     These arguments can be entered in any order and any combination
  50.     (except those that override opposite preferences).  Their meanings
  51.     are as follows:
  52.  
  53.   -V    display the current version number and copyright notice.
  54.  
  55.   -vt102 
  56.     emulate a vt102 terminal (overrides the *.emulation preference)
  57.  
  58.   -vt52    emulate a vt52 terminal (overrides the *.emulation preference)
  59.  
  60.   -h19    emulate a Zenith h19 terminal (overrides the *emulation preference)
  61.  
  62.   -7    strip 8th bit off the character codes
  63.  
  64.   -l <file> 
  65.     log the the terminal output into specified file
  66.  
  67.   -w    wait for a keypress before closing the window
  68.  
  69.   -sl    start in slow mode. This mode is useful only watching some vt102
  70.     animations.
  71.  
  72.   -g <geometry>
  73.     set up the window geometry.  The format for geometry is
  74.     left/top/width/height.  A value of -1 for the width or height makes
  75.     the window stretch to the right edge or bottom of the screen.  A
  76.     value of -1 for the top makes the window's top edge appear just
  77.     below the screen title bar.  The left and top are in pixels.  The
  78.     width and height are in characters.
  79.  
  80.   -80    use 80 columns mode.    
  81.  
  82.   -f <font>
  83.     use specified font
  84.  
  85.   -ic    hide the cursor
  86.  
  87.   -S {screen}    
  88.     Opens the Napsaterm window on the specified public screen.
  89.  
  90.   -d <device> 
  91.     use specified device. The device may be a normal Exec device name
  92.     (eg. serial.device) or one of the following:
  93.     * net - use the remote login protocol over TCP/IP (default)
  94.     * dnet - use a DNet channel
  95.  
  96.   -u <unit>
  97.     use specified device unit number
  98.  
  99.   -shared
  100.     open device in shared mode. This option is meaningful only with
  101.     serial.device
  102.  
  103.   -p {title} 
  104.     Draws the program title with given text. The actual title is
  105.     concatenated with display size indicator `(width × height)'.
  106.     Normal title is the remote host name when using rlogin,
  107.     otherwise `Napsaterm'.
  108.  
  109.   -stdio
  110.     use DOS IO, read from standard input stream and write to the
  111.     standard output stream
  112.  
  113.   -N <net>
  114.     use specified DNet network
  115.  
  116.   -B <bps> 
  117.     use specified line speed (as bits per second)
  118.  
  119.   -p {title} 
  120.     Draws the program title with given text. The actual title is
  121.     concatenated with display size indicator `(width × height)'.
  122.     Normal title is the remote host name when using rlogin,
  123.     otherwise Napsaterm.
  124.  
  125. Resources
  126.  
  127.     There is a configuration file for Napsaterm, AmiTCP:db/NapsaPrefs.
  128.     Each of its lines contains one resource, that is a name of option
  129.     and its value. Here is the example file:
  130.  
  131. # $Id: napsaterm.doc,v 1.5 1993/11/03 21:23:05 ppessi Exp $
  132. napsaterm.emulation: vt102
  133. napsaterm.linespeed: 19200
  134. napsaterm.geometry: 0/-1/81/24
  135. napsaterm.bell: visual
  136. napsaterm.altismeta: yes
  137. napsaterm.sizegadget: column
  138. napsaterm.device: net
  139. napsaterm.unit: 0
  140. napsaterm.cursor: block
  141. napsaterm.cursorblink: no
  142. napsaterm.normalDelete: yes  
  143. napsaterm.normalBackspace: no
  144. napsaterm.emacsmode: no
  145. napsaterm.fixedColumns: no
  146. napsaterm.national: no
  147. napsaterm.basefont: napsa/11
  148.  
  149. Using Napsaterm without AmiTCP/IP
  150.  
  151.     Napsaterm distributed with AmiTCP/IP is compiled to support only
  152.     TCP/IP connections. You may compile it yourself to support AmigaDOS
  153.     IO, serial devices or DNet. The TCP/IP connection is selected with
  154.     device type "net". See for the appropriate section in the Niftyterm
  155.     documentation for other supported device types.
  156.  
  157. Connecting a Remote Host with Napsaterm
  158.  
  159.     You need AmiTCP/IP up and running first. The napsaterm is given the
  160.     name of the remote host as the last argument after options:
  161.  
  162.     10.> run napsaterm argon
  163.  
  164.     The remote login name is retrieved from environment variable USER
  165.     or from resource "napsaterm.remotename". (There should be a command
  166.     line option to specify the remote login name.) The local user name
  167.     (your user name in the Amiga) is retrieved from the environment
  168.     variable USER.
  169.  
  170.     The remote login name is retrieved from resource
  171.     "napsaterm.remotename" or from environment variable USER.  (There
  172.     should be a command line option to give the remote login name.)
  173.  
  174.     If you do not have a suitable entry in your .rhosts file, the remote
  175.     host prompts for your password at first.
  176.  
  177. Why My Terminal Type Is Unknown?
  178.  
  179.     The default terminal type of Napsaterm is vt102. While most Unix
  180.     systems are familiar with vt102, some do not recognize it. vt102 is
  181.     basically a vt100 with a couple additional features. If there is
  182.     trouble with vt102 you can try to change your terminal type to
  183.     vt100.  The resource "napsaterm.remotetype" determines the terminal
  184.     type which told to the remote host.
  185.  
  186. Why to Set the Line Speed?
  187.  
  188.     The nominal terminal speed is set with option -B or resource
  189.     "napsaterm.linespeed". The Unix programs and terminal drivers use
  190.     the nominal terminal speed to determine the throughput of your
  191.     connection. There may be problems if the speed is 300 b/s while you
  192.     are using ethernet. Likewise the nominal speed of 38400 b/s over a
  193.     2400 b/s slip connection is likely to cause trouble. You can
  194.     determine your nominal line speed in the Unix systems with the stty
  195.     command.
  196.  
  197. How to Use National Character Sets and Keyboard Layouts
  198.  
  199.     There are 7 alternative national setting in the National menu of the
  200.     Napsaterm. The uppermost menu item, "Multinational/ National"
  201.     determines if the ISO 8857-Latin-1 or some national character set is
  202.     used. The rest of the menu items specify which keyboard layout and
  203.     national character set are in use.  The "usa1" keyboard layout is
  204.     available with "ASCII" national setting.
  205.  
  206.     The default national setting is determined with resource
  207.     "napsaterm.nation". The national mode can be made default by setting
  208.     the resource "napsaterm.national" to "yes".
  209.  
  210.     A national ISO 646 character set replaces some codes used for
  211.     punctuation characters in the ASCII set. Napsaterm have defined the
  212.     following sets (the default keyboard layout name is in parenthesis):
  213.  
  214.     ASCII (usa1)    #  $  @  [  \  ]  ^  `  {  |  }  ~
  215.     Danish (dk)    #  $  @  Æ  Ø  Å  ^  `  æ  ø  å  ~
  216.     Finnish    (s)    #  $  @  Ä  Ö  Å  ^  `  ä  ö  å  ~
  217.     French (f)    #  $  à  °  ç  §  ^  `  é  ù  è  ¨
  218.     German (d)    #  $  §  Ä  Ö  Ü  ^  `  ä  ö  ü  ß
  219.     Norwegian (n)      #  ¤  É  Æ  Ø  Å  Ü  é  æ  ø  å  ü
  220.     Swedish    (s)        #  ¤  É  Ä  Ö  Å  Ü  é  ä  ö  å  ü
  221.     UK (gb)            £  $  @  [  \  ]  ^  `  {  |  }  ~
  222.  
  223.     You can redefine the keyboard layout for the default nation with the
  224.     "*.keyboard" resource. If you for instance want to use Dvorak
  225.     layout, use "napsaterm.keyboard: usa2".
  226.  
  227.     There is C source for a customized Finnish keyboard layout that I
  228.     use usually. It can be compiled with GCC or SAS C.
  229.  
  230. Other Changes to the Niftyterm 1.2
  231.  
  232.     Left Alt key can be used as a 'Meta' key by setting the
  233.     "*.altismeta" resource. If you press a key with left Alt key
  234.     Napsaterm sends an Escape code (ASCII 27) before the key's
  235.     character. (Niftyterm sets the 8th bit of sent character.)
  236.  
  237.     Switching Delete and Backspace keys are now done before key code
  238.     conversion. So, Backspace key (arrow to left) may send a DEL code
  239.     (ASCII 127) but Ctrl and H sends still ^H (ASCII 8).
  240.  
  241.     A bug in the clipboard handling is now fixed. 
  242.  
  243.     Napsaterm do not free the console window when it is started, you
  244.     must start it explicitly with run. Iconify feature is removed (if
  245.     you really want it, do recompile from the sources).
  246.  
  247.     NapsaTerm uses normal single character CSI sequence. If you have
  248.     trouble with 8-bit characters, you can use two character CSI
  249.     sequence (ESC [) by adding following resource line to the napsaprefs
  250.     file: "napsaterm.ctrl8bit: no".
  251.  
  252.     
  253.